home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / dvpt2.exe / VPMOD.DOC < prev    next >
Encoding:
Text File  |  1991-12-12  |  2.9 KB  |  87 lines
  1.                Digitized Voice Programmer's Toolkit for the PC
  2.                -----------------------------------------------
  3.  
  4.                                Version 2.0
  5.  
  6.              Copyright (c) 1988,1989,1990,1991 Farpoint Software
  7.  
  8.                    Playback Procedure Call Documemtation
  9.  
  10. ------------------------------------------------------------------------------
  11.  
  12. Calibration routine
  13. -------------------
  14.  
  15. Prototype:
  16.  
  17. long pascal far PCALIBRATE(void);
  18.  
  19.  
  20. This must be called once before PLAYVOICE is called. PLAYVOICE may be called
  21. multiple times thereafter, as long as the program remains in memory.
  22.  
  23.  
  24. Return value:
  25.  
  26. Low word      Meaning
  27. --------      -------
  28.    0          success
  29.    1          this CPU is too slow to accomplish normal-speed playback
  30.    2          operation not possible under Microsoft Windows
  31.                in "Enhanced" mode
  32.    3          unusual speaker drive circuit encountered,
  33.                might not output sound correctly
  34.  
  35. The return value high word is the actual speed calibration constant for this
  36. computer. It should be 64 or higher for adequate sound quality; it should be
  37. 256 or higher for maximum quality. This number indicates the number of
  38. discrete output waveform quantization steps available.
  39.  
  40.  
  41. ------------------------------------------------------------------------------
  42.  
  43. Force Calibration Routine
  44. -------------------------
  45.  
  46. Prototype:
  47.  
  48. void pascal far PSETCAL(unsigned int calfactor);
  49.  
  50.  
  51. Normally never used, this call can be used to set the internal calibration
  52. constant normally determined by the PCALIBRATE routine. A possible use for
  53. PSETCAL would be to alter the playback speed.
  54.  
  55.  
  56. There is no return value.
  57.  
  58.  
  59. ------------------------------------------------------------------------------
  60.  
  61. Playback Routine
  62. ----------------
  63.  
  64. Prototype:
  65.  
  66. long pascal far PLAYVOICE(unsigned char far *buffer, long bytecount);
  67.  
  68.  
  69. This routine actually performs the voice output. The CPU will be fully
  70. occupied by this operation. The background mode of operation found in DVPT
  71. version 1 was sacrificed in version 2 in order to achieve the improved sound
  72. quality that you now hear. Any keypress during playback will terminate the
  73. operation. The keystroke will still be in the BIOS keystroke buffer when
  74. PLAYVOICE returns. Note that literally ANY keyboard action, including key
  75. releases and shift keys, will be sufficient to end playback.
  76.  
  77. The pointer "buffer" passed to the routine will be treated as a huge pointer,
  78. with 64k segment boundaries taken care of automatically. Also, the "bytecount"
  79. parameter is a 32 bit number. Thus, the practical limit to the size of one
  80. contiguous block of data to be played is the amount of memory available to
  81. your program.
  82.  
  83.  
  84. The return value indicates the actual number of bytes played. Unless
  85. terminated by keyboard activity, this number will be equal to the "bytecount"
  86. passed to the routine.
  87.